This sample code demonstrates how to append your own help menu items under the help menu.
As an aside, it also shows how to implement hierarchical sub menus.
This is basically how you go about appending your own help menu items:
MenuHandle helpMenu;
err = HMGetHelpMenuHandle (&helpMenu);
if (helpMenu != nil) {
AppendMenu (helpMenu, "\pThis is my help...");
}
To check for your help menu selections events your menu choice handler looks for a menu ID of kHMHelpMenuID (-16490) and your specific help item's number (your first one will start at 5).
(The MyHelpMenu project is a CodeWarrior Pro 2 project.)
Side note:
There is a bug that may or may not affect you. If you have code that switches menu bars by calling a GetMenuBar/SetMenuBar pair, your custom Help menu items will disappear. The bug is in GetMenuBar explicitly omitting system menus like the Help menu from the list it builds. This bug has already been logged in our bug database, it will be fixed in a future revision of the Mac OS. As of this writing, the bug is still not fixed in Mac OS 8.1.
Questions and comments about this sample code should go to: devsupport@apple.com.
